WeUI 是一套同微信原生视觉体验一致的H5 UI 基础样式库,由微信官方设计团队为微信 Web 开发量身设计,它只提供了一组CSS组件,可以令用户的使用感知更加统一。包含button、cell、dialog、 progress, toast、article、icon等各式元素。
jQuery WeUI 中使用的是官方 WeUI 的 CSS 代码,并提供了 jQuery/Zepto 版本的 API 实现。因为直接使用了官方的 CSS,所以你不用担心跟官方版本的冲突。实际上 jQuery WeUI == WeUI + jQuery 插件。
如果你使用过 jQuery,那么你使用 jQuery WeUI 将没有任何障碍,所有的 JS 组件都是标准的 jQuery 插件:
$.alert("我是一个对话框");
//弹出一个actionsheet
$.actions({
actions: [{
text: "编辑",
onClick: function() {
//do something
}
},{
text: "删除",
onClick: function() {
//do something
}
}]
});
<link rel="stylesheet" href="/jquery-weui/dist/lib/weui.css"> <link rel="stylesheet" href="/jquery-weui/dist/css/jquery-weui.css"> <!-- body 最后 --> <script src="/jquery-weui/dist/lib/jquery-2.1.4.js"></script> <script src="/jquery-weui/dist/js/jquery-weui.js"></script>
其中 weui.css 是官方的版本,并未做任何修改。
WeUI Button:
按钮可以使用a或者button标签。wap上要触发按钮的active态,必须触发ontouchstart事件,可以在body上加上ontouchstart=""全局触发。
按钮常见的操作场景:确定、取消、警示,分别对应class:weui_btn_primary、weui_btn_default、weui_btn_warn,每种场景都有自己的置灰态weui_btn_disabled,除此外还有一种镂空按钮weui_btn_plain_xxx,客户端webview里的按钮尺寸有两类,默认宽度100%,小型按钮宽度自适应,两边边框与文本间距0.75em:
WeUI Cell:
Cell,列表视图,用于将信息以列表的结构显示在页面上,是wap上最常用的内容结构。Cell由多个section组成,每个section包括section headerweui_cells_title以及cellsweui_cells。
cell由thumnailweui_cell_hd、bodyweui_cell_bd、accessoryweui_cell_ft三部分组成,cell采用自适应布局,在需要自适应的部分加上classweui_cell_primary即可。
WeUI Dialog:
若系统的alert窗体无法满足网页的临时视图内容需求,则可以自定义实现与alert形式相似的dialog,并且在dialog中可以自定义地使用各种控件,来满足需求。
WeUI Progress
WeUI Toast
toast用于临时显示某些信息,并且会在数秒后自动消失。这些信息通常是轻量级操作的成功、失败或等待状态信息。
WeUI Msg Page
结果页通常来说可以认为进行一系列操作步骤后,作为流程结束的总结性页面。结果页的作用主要是告知用户操作处理结果以及必要的相关细节(可用于确认 之前的操作是否有误)等信息;若该流程用于开启或关闭某些重要功能,可在结果页增加与该功能相关的描述性内容;除此之外,结果页也可以承载一些附加价值操 作,例如提供抽奖、关注公众号等功能入口。
WeUI Article
文字视图显示大段文字,这些文字通常是页面上的主体内容。Article支持分段、多层标题、引用、内嵌图片、有/无序列表等富文本样式,并可响应用户的选择操作。
在微信客户端webview中使用Article,必须保证文字有足够的可读性和可辨识性、使用规范字体、保证足够的段间距、段首无缩进。
WeUI Icon
下载+文档:http://lihongxun945.github.io/jquery-weui/